home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / doom / devil21f.zip / DEVIL.ZIP / DEVIL21 / README.TXT < prev    next >
Text File  |  1996-04-17  |  22KB  |  468 lines
  1.     Welcome to Devil, the Descent Editor for Vertices, Items and Levels.
  2.  
  3.   ____________________________________          _________________________
  4.  /                /            /     /\        /\     \            \     \
  5. /________________/____________/_____/  \      /  \_____\____________\_____\
  6. \                \            \     \   \    /   /     /            /     /
  7.  \____     ___    \     _______\     \   \  /   /     /___      ___/     /
  8.       \    \  \    \    \/______\     \   \/   /     /   /    /   /     /
  9.        \    \  \    \            \     \  ||  /     /   /    /   /     /____
  10.       / \    \  \    \     _______\     \ || /     /\  /    /\  /     /     \
  11.      /___\    \/_\    \    \/______\     \__/     /__\/    /__\/     /_______\
  12.      \                 \            \            /            /              /
  13.       \_________________\____________\__________/____________/______________/
  14.             (thanks to Catalin-Andrei Stefanescu for the ASCII art)
  15.                     
  16.                 This is the README.TXT for version V2.10
  17.          For further info refer to readme20.txt and docs/userman.doc
  18.         
  19.                 Mail address: ubdb@rz.uni-karlsruhe.de
  20.        Home page: http://wwwrzstud.rz.uni-karlsruhe.de/~ubdb/index.html 
  21.  
  22. Devil is free software, and you are welcome to redistribute it under certain
  23. conditions, therefore Devil comes with ABSOLUTELY NO WARRANTY;
  24. for details see the file 'COPYING'. Some things are copyright from DJ
  25. Delorie, for these see 'COPYING.DJ'. The graphics library is copyright
  26. by Csaba Biegel; see 'COPYING.CB'. The CWSDPMI is copyright by 
  27. Charles W Sandmann, see 'CWSDPMI.DOC'. You get GNU-C with source-code on
  28. nearly every ftp-site (for example ftp.uni-stuttgart.de).
  29.  
  30. !! Distribution with commercial or shareware programs is allowed but requires
  31. !! notification of the author by mail or acknowledged email.
  32.  
  33. Devil is sponsored by the german magazine "PC PLAYER". They are
  34. paying me some money to encourage further development of Devil :-)).
  35. In return they asked me to be allowed to show up in the new
  36. title screen. There is no other obligation. Devil IS STILL FREEWARE!
  37.  
  38. PC PLAYER can be reached by E-Mail at Devil@pcplayer.mhs.compuserve.com
  39.  
  40. ATTENTION:
  41. There is a Devil Mailing list. Have a look at
  42.  http://www.sky.net/~sclouse
  43. to subscribe.
  44. I'm subscribed in this list, too, so please mail any questions about how to 
  45. use Devil to this list and not directly to me. I WON'T ANSWER ANY MAILS
  46. EXCEPT FOR (USEFUL) BUG REPORTS!!! This is not very friendly but I get a lot 
  47. of mails like "I don't know how it works, please help me."...:-(
  48.  
  49.   CONTENTS:
  50.   
  51.   [0] THE VERSION NUMBERS.
  52.   
  53.   [1] INSTALLING Devil
  54.       [1a] What do I need to run Devil ?
  55.       [1b] How to install this thing ?
  56.       [1c] Change your configuration
  57.       [1d] Devil crashes before the titlescreen appears. 
  58.       [1e] Devil crashes after the titlescreen has appeared.
  59.       [1f] Virus Warnings with D.EXE.
  60.  
  61.   [2] BUILDING LEVELS
  62.       [2a] Building a level.
  63.       [2b] Including the level in Descent (easy way).
  64.       [2c] Including the level in Descent/Compiling your own HOG-files.
  65.       [2d] Extracting the original levels.
  66.       [2e] Restoring the original Descent.
  67.       [2f] Copying macros.
  68.  
  69.   [3] BUGS AND OTHER WELL KNOWN FEATURES
  70.       [3a] How many bugs I've to expect ?
  71.       [3b] Report a bug.
  72.  
  73.   [4] FURTHER PLANS
  74.       [4a] Next weeks.
  75.       [4b] Next months.
  76.       [4c] Never.
  77.       
  78.   [5] ONE OR TWO WORDS TO THE SOURCECODE
  79.       [5a] Why is Devil.INI so long?
  80.       [5b] Sourcecode itself.
  81.       [5c] Extending Devil.
  82.       [5d] Recompiling Devil.
  83.  
  84.   [A] UPDATES
  85.   
  86. [0] THE VERSION NUMBERS.
  87.  Since version V1.0a Devil is numbered in the following way:
  88.  The full working, official release is called V1.0, V1.1 and so on.
  89.  The beta-testing versions are called V1.0a, V1.0b, V1.0c and so on.
  90.  Please spread this thing as wide as you can.
  91.  Minor updates and bugfixes will be called V1.01, V1.02...
  92.  
  93. [1] INSTALLING Devil
  94.  
  95.  [1a] What do I need to run Devil ?
  96.   To run Devil you need the following things: 
  97.    1. Descent 1 or 2 registered version (I won't release a editor for the 
  98.       shareware version because the guys from Parallax don't want this).
  99.    2. A fast computer with coprocessor (the program isn't optimized in
  100.       any way yet, especially I do all the calculations needed for
  101.       plotting with floating point, so without a copro it's very very very
  102.       very slow, but you can try it with emu387 (is not included).
  103.       On a 486/66 it should be quite good).
  104.    3. A VESA-compatible graphics card.
  105.       
  106.  [1b] How to install this thing ?
  107.   If you have the DevilXXX.zip file just pkunzip it with '-d' (IMPORTANT!!)
  108.   anywhere you want. This will create a directory Devil with several
  109.   subdirectories. Then start the editor from the Devil directory with
  110.   "Devil". Then you get in a self-explaining (well, at least I hope it)
  111.   configuration routine where you must enter your Descent 1/2 path and
  112.   choose your graphics card/resolution.
  113.   
  114.  [1c] Change your configuration
  115.   To change the resolution and the other settings, start Devil with
  116.   "Devil /config".
  117.   
  118.  [1d] Devil crashes before the titlescreen appears. Help?
  119.   If Devil crashes with a message like General Protection Fault or something
  120.   like this, try a clean configuration only with HIMEM.SYS from MSDOS. This
  121.   should work. 
  122.   
  123.   I don't know how to use Win95/Windows 3.1 and Devil but I know
  124.   that there are some guys who have managed to do this. Try a short notice
  125.   in the mailing list for help.
  126.   
  127.   If you get no message and Devil just quits after you started it, it is
  128.   possible that Devil couldn't initialize the graphics mode. Then have a
  129.   look at the Devil.BAT file. There are some drivers mentioned. Perhaps you
  130.   can find one with a name which is similar to your card. Then change the line
  131.     set grx20drv=vesa
  132.   into
  133.     set grx20drv=<drivername>
  134.   Of course you must replace <drivername> with the name of the driver
  135.   (i.e. cl5426)
  136.   You can try to load a resident VESA-bios, too.
  137.   
  138.   It is also possible that your graphics card cannot handle the resolution
  139.   which is currently set in the Devil.ini file.
  140.  
  141.  [1e] Devil crashes after the screen has appeared.
  142.   Perhaps your level-file is corrupted. Try starting Devil with
  143.    Devil /new
  144.  
  145.  [1f] Virus Warnings with D.EXE.
  146.   If you scan D.exe with a heuristic virus scanner it will detect something
  147.   (not a virus but code that might be used to program a virus). This is
  148.   NOT a virus but code inherent to the GNU compiler.
  149.   You can safely ignore this, it is not a virus. But if your virus scanner
  150.   detects a virus with normal (not heuristic) scanning the file is 
  151.   infected and you have a problem.
  152.  
  153. [2] BUILDING LEVELS
  154.  [2a] Building a level.
  155.   Start Devil.bat. If it does some output and then returns to the DOS-prompt
  156.   see the previous sections. 
  157.   
  158.   If Devil has started, build an level. This is not an easy task, but 
  159.   I'm sure you will see how it works.
  160.   See the doc-files for documentation. You can find them in the Docs 
  161.   directory. The saved levels will be in the levels-directory (that's not very
  162.   surprising, I suppose).
  163.  
  164.  [2b] Including the level in Descent (easy way).
  165.   Just copy your levelfile in the Descent directory and name it
  166.   LEVEL01.RDL (the 01 can be replaced by 01-27,S1-S3) (D2LEVA-1.RL2
  167.   for Descent 2). Descent will load this level automatically and replace 
  168.   the original level. 
  169.   
  170.  [2c] Including the level in Descent/Compiling your own HOG-files.
  171.   If you want to produce your own missions (compilations of levels) you can
  172.   make your own HOG-files with the Mission Manager in Devil. You must store
  173.   the MSN/HOG-file produced from Devil in your Descent directory.
  174.   Descent will recognize these files and ask you which mission you want to
  175.   play.
  176.   
  177.  [2d] Extracting the original levels.
  178.   Also done with the Mission Manager.
  179.  
  180.  [2e] Copying macros.
  181.   If your friend has build some macros you want to include, just copy
  182.   them in your macros directory and start Devil.
  183.  
  184. [3] BUGS